#!/usr/bin/env perl

=head1 BASE INFORMATION

=head2 Filename

catework_app.pl

=head2 Path

script/

=head2 Notes

=head2 ToDo's

=head2 Revision

=over 4

=item *

$HeadURL$

=item * 

$Id$

=back

=head2 Source Code

=cut

use warnings;
use strict;
use FindBin qw($Bin);
use lib "$Bin/../lib";

=head1 NAME

catework_app.pl - to maintain a catwork app

=head1 SYNOPSIS

catework_appl.pl [DESTINATION] --list|info|[create|install|remove] [APPNAME]

=head2 Options:

   --help         display this help and exits
   --list         list all installed apps
   --info         view the detail information for a installed app
   --create       create a new app
   --install      install the app on a catwork server
   --remove       remove the app on the catwork server

Note: if the DESTINATION is the localhost you don't need to set it that option, if the DESTINATION 
is a remote host you need a ssh login on that host!

=head2 Examples

    # list all installed apps on the local catwork server
    catework_appl.pl --list          
    # list all installed apps on the remote catwork server gmp.treehouse.corp
    catework_appl.pl gmp.treehouse.corp --list 

    # get all configuration infos for a installed app on the local catwork server
    catework_appl.pl --info APPNAME  
    # get all configuration infos for a installed app on the remote catwork server gmp.treehouse.corp
    catework_appl.pl gmp.treehouse.corp --info APPNAME 

    # install a app on the local server
    catework_appl.pl --install /path_to_app APPNAME  
    # install a app on the server the remote catwork server gmp.treehouse.corp       
    catework_appl.pl gmp.treehouse.corp --install path_to_app APPNAME 
    
    # remove a app on the local server
    catework_appl.pl --remove APPNAME
    # remove a app on the server the remote catwork server gmp.treehouse.corp           
    catework_appl.pl gmp.treehouse.corp --removel APPNAME 
    
    # create a new catwork app
    catework_appl.pl --create /path_to_app APPNAME # create a app

=head1 DESCRIPTION

this script is written to handle all catwork app related stuff like create, deploy remove, list etc.

=head1 AUTHORS

Hans-georg Winkler

=head1 COPYRIGHT

This library is free software. You can redistribute it and/or modify
it under the same terms as Perl itself.

=cut
